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Introduction 

Multi-tenancy, a fundamental pillar of SaaS (Software as a Service) applications, 
allows the use of a single application instance to serve multiple customers or 
‘tenants’. Achieving multi-tenancy with Spring Boot, one of the most popular 
frameworks for creating stand-alone, production-grade Java applications, requires 
strategic architectural planning. This article will explore architectural patterns 


suitable for implementing multi-tenancy in Spring Boot applications. 
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Approaches to Multi-Tenancy 


Broadly, there are three main approaches to multi-tenancy: 


1. Separate Databases: Each tenant has a dedicated database. 


2. Shared Database, Separate Schemas: All tenants share a database, but each has 
a separate schema. 


3. Shared Database, Shared Schema: All tenants share the same database and 
schema. 


Let’s discuss how these patterns can be implemented in a Spring Boot application. 


Separate Databases 
In this approach, every tenant has its database. This allows complete isolation of 


tenant data. In Spring Boot, you can achieve this by setting up dynamic data sources 
routing at runtime. 


To do this, you'll need to create a DataSource bean for each tenant and a 
DataSourceRouting Class for routing between different data sources. Let's look at a 


simplified example: 


@Configuration 
public class DataSourceConfig { 


@Bean 

public DataSource dataSource() { 
TenantRoutingDataSource customDataSource = new TenantRoutingDataSource ( 
Map<Object, Object> targetDataSources = new HashMap<>(); 
// Populate targetDataSources map with tenant's DataSource 


df aes 


customDataSource.setTargetDataSources(targetDataSources) ; 
return customDataSource; 


In this example, TenantRoutingDataSource extends AbstractRoutingDataSource from 
Spring and overrides determineCurrentLookupkey() method to provide routing based 


on tenant context. 
Shared Database, Separate Schemas 
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In this approach, all tenants share a single database, but each has its own schema. 
This pattern provides a balance between data isolation and resource optimization. 
With Hibernate, which Spring Boot uses by default for ORM, you can dynamically 


set the schema based on the tenant context. 


For this approach, you can use a similar DataSource setup as the first approach. 
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public class TenantSchemaResolver implements CurrentTenantIdentifierResolver { 
@Override 
public String resolveCurrentTenantIdentifier() { 
return TenantContext.getTenantSchema(); //Get tenant's schema from tene 


} 

@Override 

public boolean validateExistingCurrentSessions() { 
return true; 


Shared Database, Shared Schema 

The third approach is where all tenants share both the database and the schema. In 
this case, you'll use a tenant column in your tables to differentiate between tenant 
data. The tenant id can be added to each request thread context at the start and 
removed at the end. 


Although this approach requires less operational complexity, it could pose a 
challenge in terms of data isolation. Careful database design and application-level 


security are necessary to prevent data leaks between tenants. 


Below is an example of how to set up a TenantEntityListener : 


public class TenantEntityListener { 
@PrePersist 
public void setTenant(TenantAware tenantAware) { 
String tenantId = TenantContext.getTenantId(); //Get tenantId from tena 
tenantAware.setTenantId(tenantId) ; 
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In this example, the TenantEntityListener sets the tenantId from the TenantContext 


before saving any TenantAware entities. 


Conclusion 

Implementing multi-tenancy in Spring Boot requires careful architectural 
considerations based on your application's needs. While separate databases provide 
maximum data isolation, shared database schemas offer a balance between 
isolation and resource use, and shared schemas reduce operational complexity. 
Spring Boot, along with Hibernate ORM, provides ample support to implement any 
of these strategies based on your requirements. 


Remember, irrespective of the approach you choose, ensure that you have a robust 
tenant context setup in place, and thorough testing is done to avoid any data leaks 
between tenants. 


1. Spring Boot Documentation 


2. Spring Data JPA Documentation: Introduction to Multitenancy 


Enjoyed the read? Not a Medium member yet? You can support my work directly by signing 
up through my referral link here. It’s quick, easy, and costs nothing extra. Thanks for your 
support! 
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